home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / ca29_3.zip / HOST.DOC < prev    next >
Text File  |  1992-11-30  |  16KB  |  660 lines
  1. COM-AND Scripted HOST
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.           -----------------------------------------
  13.                 COM-AND Scripted HOST
  14.             Script based Host mode for the IBM PC
  15.           -----------------------------------------
  16.  
  17.  
  18.  
  19.  
  20.     COM-AND, and the HOST script-set (HOST, HOSETUP, et al) are
  21.     copyright 1992 by CABER Software.  COM-AND is distributed freely
  22.     and may be copied by anyone for any number of machines, for
  23.     purposes of evaluation.  The author offers COM-AND and its
  24.     accessory programs as a package, as "shareware".  If you USE
  25.     the program after evaluating it, you MUST pay for it.
  26.  
  27.  
  28.     The complete user license and registration information is to be
  29.     found in the file REGISTER.DOC.  Limitations on redistribution
  30.     of COM-AND are set out in the file VENDOR.DOC.    These two files
  31.     are included with the COM-AND program release.
  32.  
  33.  
  34.  
  35.                  CABER Software
  36.                  R. (Scott) McGinnis
  37.                  P.O. Box 3607 Mdse Mart
  38.                  Chicago, IL 60654-0607
  39.  
  40.                  GEnie, Delphi: TARTAN
  41.                  CIS .......... 73147,2665
  42.                  Internet ..... 73147.2665@compuserve.com
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54. Version 1.1: 921012
  55.  
  56. COM-AND Scripted HOST
  57.  
  58.  
  59.                  Table of Contents
  60.                  -----------------
  61.  
  62. I.    Introduction  .............................................. page 1
  63.  
  64.     A. What is COM-AND? ........................................ page 1
  65.     B. The HOST ................................................ page 1
  66.  
  67. II.    Installing the HOST ........................................ page 2
  68.  
  69.     A. Load HOSETUP ............................................ page 2
  70.     B. Using HOSETUP ........................................... page 2
  71.     C. Exit HOSETUP and load HOST .............................. page 3
  72.  
  73. III.    External programs .......................................... page 5
  74.  
  75.     A. TREED ................................................... page 5
  76.     B. DOORWAY ................................................. page 5
  77.  
  78. IV.    Program Requirements ....................................... page 6
  79.  
  80. V.    Program and Author Information    ............................ page 7
  81.  
  82.  
  83.                 Appendices
  84.                 ----------
  85.  
  86.  
  87. A.    Modem configuration ........................................ page 8
  88.  
  89.     1. DTR ..................................................... page 8
  90.     2. CD ...................................................... page 8
  91.     3. Modem ESCAPE ............................................ page 9
  92.     4. Hangup .................................................. page 9
  93.     5. Modem Init .............................................. page 9
  94.  
  95. B.    HOSTART.CMD ................................................ page 10
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109. Version 1.1: 921012
  110.  
  111. COM-AND Scripted HOST                             Page   1
  112.  
  113.  
  114. I.    Introduction
  115.  
  116.  
  117.     A. What is COM-AND?
  118.  
  119.  
  120.        COM-AND for the IBM PC and compatibles is a communications program
  121.        for use by itself, or for use with several integrated accessory
  122.        programs (which themselves may be used independently of COM-AND).
  123.        COM-AND provides standard comm program functions:  a dialing dir-
  124.        ectory, macros, disk logging, binary and ASCII file transfers, and
  125.        a script language.
  126.  
  127.  
  128.     B. The HOST
  129.  
  130.        This document details the HOST script provided with COM-AND.  Two
  131.        levels of hosting are provided.  First, password protected logon
  132.        and a limited set of functions are provided.  The functions are:
  133.  
  134.        o   C)hdir               Change current directory
  135.        o   F)ilelist           List files in current subdirectory
  136.        o   P)athlist           Graphically list paths
  137.        o   U)pload               Upload a file using WXMODEM,
  138.                        XMODEM, YMODEM, ZMODEM or KERMIT
  139.        o   D)ownload           Download a file using WXMODEM,
  140.                        XMODEM, YMODEM, ZMODEM or KERMIT
  141.        o   E)xit               Logoff
  142.  
  143.        Two additional functions are accessed with a second password (the
  144.        commands 'x' and 'y' are NOT listed on the HOST menu):
  145.  
  146.        o   X:  DOS commands may be executed at this level.    [NOTE:    DOS
  147.            commands supporting redirected I/O are only 'usable' here.
  148.            DOS functions prompting for keyboard input may 'hang' the
  149.            HOST script.]
  150.  
  151.        o   Y:  A drop-to-DOS is supported, using a doorway utility (such
  152.            as Marshall Dudley's DOORWAY).  COM-AND is terminated, and
  153.            the doorway loaded, allowing full access to the machine.
  154.            On termination of the doorway, COM-AND is reloaded, and
  155.            the HOST script re-entered.
  156.  
  157.        The supplied HOST script works best if your modem is set to report
  158.        the real state of Carrier Detect (CD).  However, it has been used
  159.        quite successfully with modems reporting Carrier Detect always
  160.        true (when disconnect occurs, Hayes compatible modems report the
  161.        fact with 'NO CONNECT', and HOST is coded to look for it).
  162.  
  163.  
  164. Version 1.1: 921012
  165.  
  166. COM-AND Scripted HOST                             Page   2
  167.  
  168.  
  169. II.    Installation
  170.  
  171.  
  172.     Included with the HOST script is a utility script, HOSETUP.  HOSETUP
  173.     is used to configure the HOST if default values are not desired (and
  174.     rarely are they!).
  175.  
  176.  
  177.     A. Load HOSETUP
  178.  
  179.        Load COM-AND and invoke HOSETUP.  For example, from the DOS
  180.        prompt:
  181.  
  182.          "d>" COM-AND /fHOSETUP
  183.  
  184.        loads COM-AND and invokes the HOSETUP script.  [This document
  185.        assumes scripts are on the current subdirectory, or the subdir-
  186.        ectory pointed by the COM-AND= environment variable.]
  187.  
  188.        If HOSETUP is used to change any default values, a file, HOSTDAT
  189.        is created for the HOST script.  HOSTDAT is created on the sub-
  190.        directory pointed by the COM-AND= environment variable.  In the
  191.        absence of the variable, HOSTDAT is created on the current direc-
  192.        tory (in which case HOST MUST be executed from THAT directory).
  193.  
  194.  
  195.  
  196.     B. Using HOSETUP
  197.  
  198.        From HOSETUP's main menu, select the items in numeric order.
  199.  
  200.        1) Identify modem values
  201.  
  202.           a) Identify modem port; The default value is the default for
  203.          COM-AND.  You may wish to change this for the HOST.  What-
  204.          ever port you indicate becomes the HOST's comm port.
  205.  
  206.           b) Identify modem speed; The default value is the default for
  207.          COM-AND.  You may wish to change this for the HOST.  This is
  208.          the speed set by the HOST when waiting for a call.
  209.  
  210.           c) Identify modem control string;  The default value for this
  211.          is appropriate for most Hayes compatible modems.  It may
  212.          need modification for some modems; if so, refer to the
  213.          documentation included with the modem.
  214.  
  215.  
  216.  
  217.  
  218.  
  219. Version 1.1: 921012
  220.  
  221. COM-AND Scripted HOST                             Page   3
  222.  
  223.  
  224. II.    Installation (continued)
  225.  
  226.  
  227.     B. Use HOSETUP (continued)
  228.  
  229.        2) Identify passwords used by HOST;
  230.  
  231.           a) Identify the LOGON password.  Callers may use ANY name, but
  232.          MUST use this password.  The default is "****".
  233.  
  234.           b) Identify the DOS password.  Once connected, as described
  235.          above, DOS functions are available.  To access the DOS
  236.          functions, the DOS password is required.  The default is
  237.          "xxxx".
  238.  
  239.  
  240.        3) Identify the doorway command;
  241.  
  242.           The doorway command carries both the file name of the doorway
  243.           utility, and any parameters required.  For example:
  244.  
  245.           c:\doorway\doorway com4 /S:* /G:ON /V:B^U /M:1000 /C:DOS /V:D
  246.  
  247.           The command, exactly as typed is executed by DOS when a drop-
  248.           to-DOS is executed.
  249.  
  250.           If this command is left null (its default), the drop-to-DOS
  251.           function is inhibited.
  252.  
  253.  
  254.     C. Exit HOSETUP and load HOST
  255.  
  256.        ESC or successive carriage returns exits HOSETUP.  Back in
  257.        COM-AND, invoke HOST through the F2 key.  In the script prompt
  258.        window, for example, type:
  259.  
  260.         \HOST\HOST
  261.  
  262.        Two HOST script files are included in each release.    The script
  263.        HOST.SRC is commented source for the HOST.  The file HOST.CMD is a
  264.        stripped script; it contains no comments and is not very readable.
  265.        HOST.CMD is the script to be executed.  Stripped, it executes
  266.        faster than HOST.SRC.  HOST.SRC is provided for the intrepid who
  267.        who wish to modify the HOST.
  268.  
  269.        [COM-AND does not recognize HOST.SRC as a script unless the ".SRC"
  270.        extension is stated explicitly when the script is invoked.]
  271.  
  272.  
  273.  
  274. Version 1.1: 921012
  275.  
  276. COM-AND Scripted HOST